home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 22 / AACD 22.iso / AACD / Utilities / MCControl / Bonus / Developer / SGT / SGT.doc
Encoding:
Text File  |  2001-04-11  |  2.0 KB  |  63 lines
  1. ;----------------------------------------------------------------------------
  2. ;----------------------------------------------------------------------------
  3. ;This is an documentation about how to write patch code for special games
  4. ;----------------------------------------------------------------------------
  5. ;----------------------------------------------------------------------------
  6.  
  7.    How to use these SGT files? Well,  its  very  simple.  MCControl  calls
  8.    these  file twice! The first time its for the init process and a second
  9.    time for the final update.
  10.  
  11.    Note: The command will be reloaded, so saving data within the command
  12.    is useless.
  13.  
  14.    Example:
  15.  
  16.    Your save game stores the lives multiplied by 6:
  17.  
  18.    Mode_Pre:  Divide the lives by 6 and write result into the PSX file.
  19.    Mode_Post: Multiply the value given by the gadgets by 6 and write the
  20.               result into the given PSX file.
  21.  
  22.    If you need room for storage then feel free to use up  to  16384  Bytes
  23.    behind  the  given PSX file. (see Pitfall3D, where the offset 10000 and
  24.    up is used for data storage)
  25.  
  26. ;----------------------------------------------------------------------------
  27.  *General*
  28.  
  29.         RSRESET
  30. SGTF_RTS                   rs.w 1 ;to avoid crash when user is starting module
  31. SGTF_Version               rs.w 1 ;Currently 0
  32. SGTF_ID                    rs.l 1 ;must be "SGTF"
  33.  
  34.    In Assembler this looks like this:
  35.  
  36.    RTS
  37.    dc.w 0
  38.    dc.l "SGTF"
  39.  
  40.    Your routine is placed direct behind this header  using  the  following
  41.    arguments:
  42.  
  43.    >a0.l Pointer on PSX File
  44.    >d0.l Mode
  45.  
  46.    a0 points on the PSX file memory buffer. Its allowed to use up to 16384
  47.    bytes  after  the real PSX file.
  48.  
  49.    Where mode (d0) specifies:
  50.  
  51.    SGTF_Mode_Pre  = 0
  52.    SGTF_Mode_Post = 1
  53.  
  54.    The SGTF_Mode_Pre mode is used before opening the window,  so  you  can
  55.    setup  the  gadget  values!  The  mode  SGTF_Mode_Post  is  used  after
  56.    processing the gadget commands and before the checksum command.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.